home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmStringGetNextSegment.z
/
XmStringGetNextSegment
Wrap
Text File
|
1998-10-30
|
4KB
|
67 lines
XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt - A compound string function that
fetches the bytes in the next segment of a compound string
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Xm.h>
BBBBoooooooolllleeeeaaaannnn XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnntttt(
XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnntttteeeexxxxtttt ccccoooonnnntttteeeexxxxtttt,
cccchhhhaaaarrrr ********tttteeeexxxxtttt,
XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ****ttttaaaagggg,
XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn ****ddddiiiirrrreeeeccccttttiiiioooonnnn,
BBBBoooooooolllleeeeaaaannnn ****sssseeeeppppaaaarrrraaaattttoooorrrr);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
This routine is obsolete and exists for compatibility with
previous releases. To read the contents of a compound
string, read each component of the string with
XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttTTTTrrrriiiipppplllleeee. This XXXXmmmmSSSSttttrrrriiiinnnngggg function returns the
type, length, and value of the next component in the
compound string. XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttSSSSeeeeggggmmmmeeeennnnttttfetches the bytes in
the next segment; repeated calls fetch sequential segments.
The _t_e_x_t, _t_a_g, and _d_i_r_e_c_t_i_o_n of the fetched segment are
returned each time. A Boolean status is returned to indicate
whether a valid segment was successfully parsed.
If the function returns True, then the function allocates
space to hold the returned _t_e_x_t and _t_a_g. The application is
responsible for managing the allocated space. The
application can recover the allocated space by calling
XXXXttttFFFFrrrreeeeeeee.
_c_o_n_t_e_x_t Specifies the string context structure which was
allocated by the XXXXmmmmSSSSttttrrrriiiinnnnggggIIIInnnniiiittttCCCCoooonnnntttteeeexxxxtttt function
_t_e_x_t Specifies a pointer to a NULL-terminated string
_t_a_g Specifies a pointer to the font list element tag
associated with the text
_d_i_r_e_c_t_i_o_n Specifies a pointer to the direction of the text
_s_e_p_a_r_a_t_o_r Specifies whether the next component of the
compound string is a separator
RRRREEEETTTTUUUURRRRNNNN
Returns True if a valid segment is found.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3) and XXXXmmmmSSSSttttrrrriiiinnnnggggIIIInnnniiiittttCCCCoooonnnntttteeeexxxxtttt(3).
Page 1 (printed 10/24/98)